Disposition Property

The Disposition parameter provides optional information for the API to access model data specified by the Locator parameter.

The following table describes the syntax supported by the Disposition property:

Syntax

Arguments

param=value[;param=value]…n

param: This is either a parameter name or a keyword.

value: Yes/No/specified values for some params.

The following table lists Disposition param keywords for use with the erwin type of provider, such as for models stored in the file system:

Complete Name

Abbreviation

Description

Read Only

RDO

Requests read-only access to a file. Available for the Persistence Unit Collection Add method.

Full access to a persistence unit is possible if the parameter was not specified.

Overwrite File

OVF

Overwrites an existing file upon Save. Available for the Persistence Unit Save method. There is no overwrite if the parameter is not specified.

Main Subject Area

MSA

Keep the main Subject Area

Value: Yes/No

Diagram

DGM

Keep the diagrams for the main Subject Area

Value: Yes/No

Theme

THM

Apply a default theme to each diagram

Value: Yes/No

Transforms

XFM

Transform object view should be converted into a specified type. The param values are:

  1. �XFM=RESOLVE� (default value if the parameter was not specified)

    [It converts the model transform objects into Target object view ]

  2. �XFM=REVERSE� [It converts the model transform objects into Source object view)]
  3. �XFM=CONVERT�[It converts the Model transform objects into current view in which the model is having]

For example: The disposition parameter is as follows: (�RDO=Yes;MSA=Yes;DGM=NO;THM=Yes;XFM=�REVERSE�)

The following table lists Disposition param keywords for use with the mart type of provider for models opened from, or stored in a mart:

Complete Name

Abbreviation

Description

Read Only

RDO

Request a read only access to a model while opening it from Mart.

Overwrite Session

OVS

Overwrite an existing session. If the parameter is not specified, it uses the existing session; if not, it creates a session.

Overwrite Model

OVM

Overwrite an existing model in a mart. Available for the Persistence Unit Save method. There is no overwrite if the parameter is not specified.